package top.lixunda.ecommerce.server.user.api.controller;

import com.baomidou.mybatisplus.core.metadata.IPage;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.*;
import top.lixunda.commerce.common.core.entity.MessageObject;
import top.lixunda.common.validate.XumValid;
import top.lixunda.ecommerce.server.business.api.entity.dto.PageDTO;
import top.lixunda.ecommerce.server.user.api.entity.db.BusinessTaskDO;
import top.lixunda.ecommerce.server.user.api.entity.dto.BusinessTaskQueryDTO;
import top.lixunda.ecommerce.server.user.api.entity.vo.BusinessTaskVO;

import java.util.List;

/**
 * 业务代办任务管理
 *
 * @author lixunda
 * @version time:2020/4/13 13:53
 */
@Api("业务代办任务管理")
@RequestMapping("/business_task")
public interface IBusinessTaskController {

    /**
     * 通过taskId查询代办任务信息，管理员权限
     *
     * @param taskId 任务编号
     * @return 代办任务信息，包括所有的任务分配数据
     */
    @ApiOperation(value = "通过taskId查询代办任务信息", notes = "管理员权限")
    @GetMapping("queryTaskByTaskId")
    MessageObject<BusinessTaskVO> queryTaskByTaskId(@RequestParam("taskId") Integer taskId);

    /**
     * 通过taskName查询当前登陆人员的代办任务信息，管理员权限
     *
     * @param taskName 任务名称
     * @return 代办任务信息，只包括当前登陆人员的任务分配数据
     */
    @ApiOperation(value = "通过taskName查询当前登陆人员的代办任务信息", notes = "管理员权限")
    @GetMapping("queryTaskByTaskName")
    MessageObject<List<BusinessTaskVO>> queryTaskByTaskName(@RequestParam("taskName") String taskName);

    /**
     * 通过条件分页查询代办任务信息，管理员权限
     *
     * @param pageDTO 条件分页数据
     * @return 分页的代办任务信息
     */
    @ApiOperation(value = "通过条件分页查询代办任务信息", notes = "管理员权限")
    @PostMapping("queryTaskByPageWrapper")
    MessageObject<IPage<BusinessTaskVO>> queryTaskByPageWrapper(
            @RequestBody @XumValid PageDTO<BusinessTaskDO, BusinessTaskQueryDTO> pageDTO);

    /**
     * 根据taskId查询当前登陆人员的代办任务，登陆权限
     *
     * @param taskId 任务编号
     * @return 代办任务数据
     */
    @ApiOperation(value = "根据taskId查询当前登陆人员的代办任务", notes = "登陆权限")
    @GetMapping("queryUserToDoByTaskId")
    MessageObject<BusinessTaskVO> queryUserToDoByTaskId(@RequestParam("taskId") Integer taskId);

    /**
     * 根据taskName查询当前登陆人员的代办任务，登陆权限
     *
     * @param taskName 任务名称
     * @return 代办任务数据
     */
    @ApiOperation(value = "根据taskName查询当前登陆人员的代办任务", notes = "登陆权限")
    @GetMapping("queryUserToDoByTaskName")
    MessageObject<List<BusinessTaskVO>> queryUserToDoByTaskName(@RequestParam("taskName") String taskName);

    /**
     * 根据条件分页信息查询当前登陆人员的代办任务，登陆权限
     *
     * @param pageDTO 条件分页数据
     * @return 分页的代办任务信息
     */
    @ApiOperation(value = "根据条件分页信息查询当前登陆人员的代办任务", notes = "登陆权限")
    @PostMapping("queryUserToDoByPageWrapper")
    MessageObject<IPage<BusinessTaskVO>> queryUserToDoByPageWrapper(
            @RequestBody @XumValid PageDTO<BusinessTaskDO, BusinessTaskQueryDTO> pageDTO);

    /**
     * 根据taskId删除任务，管理员权限
     *
     * @param taskIds 任务编号列表
     * @return 关闭的任务数据
     */
    @ApiOperation(value = "根据taskId删除任务", notes = "管理员权限")
    @PostMapping("removeTaskByTaskIds")
    MessageObject<List<BusinessTaskVO>> removeTaskByTaskIds(
            @RequestBody List<Integer> taskIds);
}
